The system data type TADDR_Param contains address information consisting of an IPV4 address and the port number.
The LGF_StringToTaddr function converts a variable od data type String to a TADDR_Param system data type variable.
| LGF_StringToTaddr (FC) | ||||||||
|---|---|---|---|---|---|---|---|---|
| String | ipAddressString | Ret_Val | TADDR_Param | |||||
| error | Bool | |||||||
| status | Word | |||||||
| Identifier | Data type | Description |
|---|---|---|
| ipAddressString | String | IPV4 address string in the format of `192.168.1.200:55047` [Port number including colon `:` is optional] |
| Identifier | Data type | Description |
|---|---|---|
| Ret_Val | TADDR_Param | IP-Address and Port number as `TADDR_Param` data type |
| error | Bool | FALSE: No error TRUE: An error occurred during the execution of the FB |
| status | Word | 16#0000-16#7FFF: Status of the FB 16#8000-16#FFFF: Error identification (see following Table) |
| Code / Value | Identifier / Description |
|---|---|
| 16#0000 | STATUS_FINISHED_NO_ERROR Status: Execution finished without errors |
| 16#8110 | ERR_OCTET_WRONG_NUMBER_OF_CHAR Error: Wrong number / too many characters in the X'th octet of the IP address |
| 16#8120 | ERR_OCTET_STRING_IS_EMPTY Error: No number/ character in the X'th octet of the IP address is given - String is empty |
| 16#8130 | ERR_OCTET_EXCEEDS_MAX_IP_ADDRESS Error: Maximum possible number of IP address octet exceeded (255) |
| 16#8150 | ERR_PORT_WRONG_NUMBER_OF_CHAR Error: Wrong number / to many characters in string port conversion |
| 16#8151 | ERR_PORT_STRING_IS_EMPTY Error: No number/ character in the Port string is given - String is empty |
| 16#8152 | ERR_PORT_EXCEEDS_MAX_PORT Error: Maximum number of Port exceeded (65535) |
The function converts the IPV4 address with or without port number from data type String to TADDR_Param.
The string must be in the following form:
[0..255].[0..255].[0..255].[0..255][0..255].[0..255].[0..255].[0..255]:[0..65535]192.168.11.11192.168.11.11:3294ipAddressString parameter, the Ret_Val.REM_PORT_NR parameter returns 0.| Version & Date | Change description | |
|---|---|---|
| 1.0.0 | Siemens Industry Online Support | |
| 30.01.2017 | First released version | |
| 1.0.1 | Siemens Industry Online Support | |
| 17.08.2018 | Upgrade: TIA V15 Update 2 | |
| 1.0.2 | Siemens Industry Online Support | |
| 23.11.2018 | Upgrade: TIA V15.1 | |
| 1.0.3 | Simatic Systems Support | |
| 10.06.2019 | Standard header and block parameters update | |
| 1.0.4 | Simatic Systems Support | |
| 10.07.2019 | Code refactoring and performance improvements | |
| 1.0.6 | Simatic Systems Support | |
| 14.11.2019 | Add ENO handling | |
| 3.0.0 | Simatic Systems Support | |
| 23.04.2020 | Set version to V3.0.0 Harmonize the version of the whole library | |
| 3.0.1 | Simatic Systems Support | |
| 23.02.2021 | Insert documentation | |